

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Element List [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, View Options,View Options Element List,Report View,Report View Now Element List,View,View Element List,Generate,Generate Report On Project,Generate Report On Elements,Generate RTF Report From Element List,RTF Report,RTF Report Generate From Element List,Rich Text Format Report,Rich Text Format Report Generate From Element List,Element,Element Work On From Element List,Element List,Element List Description,Element List Was Report View">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Element List</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="diagramview.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="element_list_options.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">The </span><span class="f_UIControl">Element List</span><span class="f_BodyText"> is a tabular, editable view of elements that can be displayed in the main workspace. You can use the </span><span class="f_UIControl">Element List</span><span class="f_BodyText"> to streamline the process of creating and updating elements in a package or diagram selected from the </span><span class="f_UIControl">Project Browser</span><span class="f_BodyText">. </span><span class="f_BodyText">This can be particularly useful for analysts to create and maintain formal requirement definitions within the model. </span><span class="f_BodyText">You can also <a href="element_list_options.htm#Workon">print the list or generate an RTF document</a> directly from the entries on the </span><span class="f_UIControl">Element List</span><span class="f_BodyText">.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To access the </span><span class="f_UIControl">Element List</span><span class="f_BodyText">, either:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">Select a diagram or package in the </span><span class="f_UIControl">Project Browser</span><span class="f_Bulletlist1"> and select the </span><span class="f_MenuKeyField">View | Element List</span><span class="f_Bulletlist1"> menu option</span></li>
<li><span class="f_Bulletlist1">Select a diagram or package in the </span><span class="f_UIControl">Project Browser</span><span class="f_Bulletlist1"> and press </span><span class="f_MenuKeyField"> [Ctrl]+[Alt]+[R]</span></li>
<li><span class="f_Bulletlist1">Right-click on a diagram or package in the </span><span class="f_UIControl">Project Browser</span><span class="f_Bulletlist1"> and select the </span><span class="f_MenuKeyField">Show Element List</span><span class="f_Bulletlist1"> menu option</span></li>
<li><span class="f_Bulletlist1">Right-click on the background of an open diagram and select the </span><span class="f_MenuKeyField">Show as Element List</span><span class="f_Bulletlist1"> context menu option</span></li>
<li><span class="f_Bulletlist1">Click on the </span><span class="f_MenuKeyField">Element List</span><span class="f_Bulletlist1"> button on the </span><span class="f_UIControl"><a href="other_windows_toolbar.htm">Other Views</a></span><span class="f_Bulletlist1"> toolbar.</span><br>
<span class="f_Bulletlist1">&nbsp;</span><br>
<img src="reportviewtoolbar.png" width="155" height="42" border="0" alt="ReportViewToolbar"></li>
</ul>
<p class="p_BodyText"><span class="f_BodyText">The </span><span class="f_UIControl">Element List</span><span class="f_BodyText"> tab displays, showing the element information for the selected package or diagram.</span></p>
<p class="p_TextIndentedL2"><img src="reportview.png" width="780" height="476" border="0" alt="ReportView"></p>
<p class="p_BodyText"><span class="f_BodyText">In the </span><span class="f_UIControl">Element List</span><span class="f_BodyText"> you can:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">Sort the items by any column value in ascending or descending order, by clicking on the column header; initially the elements are listed in numerical order (if level numbering is turned on in the </span><span class="f_UIControl">Project Browser</span><span class="f_Bulletlist1">)</span></li>
<li><span class="f_Bulletlist1">Change the sequence of columns, by dragging column headers left or right; however, the order you place them in is not retained in subsequent sessions</span></li>
<li><span class="f_Bulletlist1">Impose a hierarchical structure on the information in the report, as shown above; see <a href="reportview.htm#View">View Header</a>, below</span></li>
<li><span class="f_Bulletlist1">Display the </span><span class="f_UIControl">Properties</span><span class="f_Bulletlist1"> dialog for an item by double-clicking on the item entry</span></li>
<li><span class="f_Bulletlist1">Select:</span></li>
</ul>
<ul style="text-indent: 0px; margin-left: 65px; list-style-position: outside;">
<li><span class="f_Bulletlist3">An element by clicking on it</span></li>
<li><span class="f_Bulletlist3">A specific value by clicking twice on it (not double-clicking); either the value becomes directly editable or the </span><span class="f_UIControl">Properties</span><span class="f_Bulletlist3"> dialog displays in which you can edit the value</span></li>
<li><span class="f_Bulletlist3">Several individual elements by holding </span><span class="f_MenuKeyField">[Ctrl]</span><span class="f_Bulletlist3"> as you click on them</span></li>
<li><span class="f_Bulletlist3">A range of elements by holding </span><span class="f_MenuKeyField">[Shift]</span><span class="f_Bulletlist3"> as you click on the first and last in the range.</span></li>
</ul>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">Add new items to the </span><span class="f_UIControl">Element List</span><span class="f_Bulletlist1"> by pressing </span><span class="f_MenuKeyField">[Ctrl]+[N]</span><span class="f_Bulletlist1"> or </span><span class="f_MenuKeyField">[Insert]</span></li>
<li><span class="f_Bulletlist1">Automatically add elements to a diagram by generating the </span><span class="f_UIControl">Element List</span><span class="f_Bulletlist1"> on the diagram and adding elements to the list</span></li>
<li><span class="f_Bulletlist1">Delete elements from the list by selecting the item and pressing </span><span class="f_MenuKeyField">[Ctrl]+[D]</span><span class="f_MenuKeyField" style="font-weight: normal;">.</span></li>
</ul>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Tip:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="952" bgcolor="#f7f7ff" style="width:952px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">You can also include each element's documentation (notes), where it exists. This is a useful way to determine which elements in a diagram require further work and which are complete. You can add or edit notes by clicking on the item and pressing </span><span class="f_MenuKeyField">[Enter]</span><span class="f_TiporNoteText">.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">You can do further work on the </span><span class="f_UIControl">Element List</span><span class="f_BodyText"> using the toolbar and context menu <a href="element_list_options.htm">options</a>.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">The View Header<a name="view"></a></span></p>
<p class="p_TextIndentedL2"><img src="searchviewtoolbar.png" width="965" height="54" border="0" alt="SearchViewToolbar"></p>
<p class="p_BodyText"><span class="f_BodyText">The View header defines the columns of information that are presented by the </span><span class="f_UIControl">Element List</span><span class="f_BodyText">, and the order in which data items are presented. By right-clicking on the header you display the </span><span class="f_MenuKeyField">Field Chooser</span><span class="f_BodyText"> option, which in turn displays the </span><span class="f_UIControl">Field Chooser</span><span class="f_BodyText"> dialog. This enables you to add or remove columns from the output.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="161" style="width:161px;"><p class="p_TextIndentedL2"><img src="fieldchooser.png" width="121" height="210" border="0" alt="FieldChooser"></p>
</td>
<td valign="top" width="804" style="width:804px;"><p class="p_BodyText"><span class="f_BodyText">&nbsp;</span><br>
<span class="f_BodyText">To </span><span class="f_BodyText" style="font-style: italic;">add</span><span class="f_BodyText"> a column heading to the View header, drag it from the </span><span class="f_UIControl">Field Chooser</span><span class="f_BodyText"> dialog onto the header, to the position you want the column of data to display. Conversely, if you want to </span><span class="f_BodyText" style="font-style: italic;">remove</span><span class="f_BodyText"> a column from the output, drag the column heading from the View header onto the </span><span class="f_UIControl">Field Chooser</span><span class="f_BodyText"> dialog. When you have selected the column headings you require, click on the red cross in the top right corner of the </span><span class="f_UIControl">Field Chooser</span><span class="f_BodyText"> dialog to close it.</span></p>
<p class="p_BodyText"><span class="f_BodyText">You can also change the sequence of columns, by dragging column headers left or right; however, the order you place them in is not retained in subsequent sessions.</span></p>
<p class="p_BodyText"><span class="f_BodyText">You can organize the reported data hierarchically according to the value of one or more of the column categories. As in the illustration at the start of this topic, you might organize the data by </span><span class="f_BodyText" style="font-style: italic;">Type</span><span class="f_BodyText">, and within each Type by </span><span class="f_BodyText" style="font-style: italic;">Name</span><span class="f_BodyText">. If you then click on any of the other column headings, the data within this grouping is further sorted with the values of the selected column (for example, </span><span class="f_BodyText" style="font-style: italic;">Created</span><span class="f_BodyText">) in ascending or descending order.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To set up the hierarchical grouping, drag the column heading representing the primary grouping (such as </span><span class="f_BodyText" style="font-style: italic;">Type</span><span class="f_BodyText">) onto the </span><span class="f_MenuKeyField">Drag a column header here to group by that column</span><span class="f_BodyText"> field. Then drag the column heading for the next level of grouping (such as </span><span class="f_BodyText" style="font-style: italic;">Name</span><span class="f_BodyText">) to the right of the first heading. The two heading titles display as connected blocks, as shown below.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_TextIndentedL2"><img src="reporthierarchy.png" width="181" height="45" border="0" alt="ReportHierarchy"></p>
<p class="p_BodyText"><span class="f_BodyText">You can, if required, add further levels of grouping by dragging other column headings onto the hierarchy (such as </span><span class="f_BodyText" style="font-style: italic;">Status</span><span class="f_BodyText">), and restructure the hierarchy by dragging existing or additional headings into the level you want them to hold. For example, you could make </span><span class="f_BodyText" style="font-style: italic;">Type</span><span class="f_BodyText"> the secondary grouping by dragging it to the right of </span><span class="f_BodyText" style="font-style: italic;">Name</span><span class="f_BodyText">, or drop </span><span class="f_BodyText" style="font-style: italic;">Status</span><span class="f_BodyText"> between </span><span class="f_BodyText" style="font-style: italic;">Type</span><span class="f_BodyText"> and </span><span class="f_BodyText" style="font-style: italic;">Name</span><span class="f_BodyText">.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To remove a grouping level, drag the appropriate column heading out of the hierarchy and below the View header. Any subordinate groupings move up a level.</span></p>




            </div>
          </div>
        </div>



</div>


</body>
</html>
